home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1997 / MacHack 1997.toast / Hacks / Hacks ’95 / Closure / Sources / PhotoshopHeaders / DialogUtilities.h < prev    next >
Encoding:
C/C++ Source or Header  |  1995-06-24  |  4.8 KB  |  166 lines  |  [TEXT/MPS ]
  1. /* Plug-in module utility routines */
  2.  
  3. /* Copyright 1993-95 by Adobe Systems, Inc.  All rights reserved. */
  4.  
  5. /* The routines in this module provide a collection of utilities for doing
  6.  * things like centering dialogs, etc.. They expect that the host's A5-world
  7.  * is the currently active A5-world.
  8.  */
  9.  
  10. #ifndef __DialogUtilities__
  11. #define __DialogUtilities__
  12.  
  13. #include <Dialogs.h>
  14. #include <stddef.h>
  15. #include <Types.h>
  16.  
  17. #include "PIGeneral.h"
  18.  
  19. /*****************************************************************************/
  20.  
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24.  
  25. /*****************************************************************************/
  26.  
  27. /* Set the cursor to the arrow cursor. */
  28.  
  29. void SetArrowCursor ();
  30.  
  31. /*****************************************************************************/
  32.  
  33. /* Centers a dialog template 1/3 of the way down on the main screen. */
  34.  
  35. void CenterDialog (DialogTHndl dt);
  36.  
  37. /* The following routine sets up a moveable modal dialog. */
  38.  
  39. void SetUpMoveableModal (DialogTHndl dt, OSType hostSig);
  40.                          
  41. /* The following routine takes the place of ModalDialog in running moveable
  42.  * modal dialogs.
  43.  */
  44.                          
  45. void MoveableModalDialog (DialogPtr dp,
  46.                           ProcessEventProc processEvent,
  47.                           ModalFilterProcPtr filter,
  48.                           short *item);
  49.                           
  50. /* Except within the filter procedure for such moveable modal dialogs, we need
  51.    to call the following routine to get the window refcon since
  52.    MoveableModalDialog stomps it. */
  53.    
  54. long GetMoveableWRefCon (DialogPtr dp);
  55.                           
  56. /* The following routine displays a centered alert. */
  57.  
  58. short ShowAlert (short alertID);
  59.  
  60. /* The following routine displays a standard about box dialog. */
  61.  
  62. void ShowAbout (short dialogID);
  63.  
  64. /*****************************************************************************/
  65.  
  66. /* The following routine sets a user item to be a group box.  It expects
  67.    the next item to be the title for the group box. */
  68.  
  69. void SetOutlineGroup (DialogPtr dp, short groupItem);
  70.  
  71. /*****************************************************************************/
  72.  
  73. /* The following routine selects an edit text item. */
  74.  
  75. void SelectTextItem (DialogPtr dp, short item);
  76.  
  77. /* The following routine sets the text of a text item. */
  78.  
  79. void StuffText (DialogPtr dp, short item, Str255 text);
  80.  
  81. /* The following routine extracts the text of a text item. */
  82.  
  83. void FetchText (DialogPtr dp, short item, Str255 text);
  84.  
  85. /* The following routine stuffs a numeric value into a text field. */
  86.  
  87. void StuffNumber (DialogPtr dp, short item, long value);
  88.  
  89. /* Here is the corresponding routine to retrieve the value from a text
  90.    field.  It will do range checking and validate that it has been
  91.    handed a number.  If it has not been handed a number, it brings up
  92.    an appropriate error dialog, inserts an appropriately pinned value,
  93.    and selects the item.
  94.   
  95.    It returns TRUE iff it gets a valid value in the field. */
  96.  
  97.  Boolean FetchNumber (DialogPtr dp,
  98.                        short item,
  99.                       long min,
  100.                       long max,
  101.                       long *value);
  102.  
  103. /*****************************************************************************/
  104.  
  105. /* Set the state of a check box (or radio button). */
  106.  
  107. void SetCheckBoxState (DialogPtr dp, short item, Boolean checkIt);
  108.  
  109. /* Determine the state of a check box (or radio button). */
  110.  
  111. Boolean GetCheckBoxState (DialogPtr dp, short item);
  112.  
  113. /* Toggle a check box and return the new state. */
  114.  
  115. Boolean ToggleCheckBoxState (DialogPtr dp, short item);
  116.  
  117. /* Set a radio group (from first to last item) to reflect the selection. */
  118.  
  119. void SetRadioGroupState (DialogPtr dp, short first, short last, short item);
  120.                          
  121. /* Get the selected button within a radio group. */
  122.  
  123. short GetRadioGroupState (DialogPtr dp, short first, short last);
  124.  
  125. /* Set the value for a pop-up menu. */
  126.  
  127. void SetPopUpMenuValue (DialogPtr dp, short item, short newValue);
  128.  
  129. /* Get the value for a pop-up menu. */
  130.  
  131. short GetPopUpMenuValue (DialogPtr dp, short item);
  132.  
  133. /* Utility routine to disable a control. */
  134.  
  135. void DisableControl (DialogPtr dp, short item);
  136.  
  137. /* Utility routine to enable a control. */
  138.  
  139. void EnableControl (DialogPtr dp, short item);
  140.  
  141. /* Utility routine to enable (TRUE) or disable (FALSE) a control. */
  142.  
  143. void EnableDisableControl (DialogPtr dp, short item, Boolean state);
  144.  
  145. /* Utility routine to invalidate an item. */
  146.  
  147. void InvalItem (DialogPtr dp, short item);
  148.  
  149. /*****************************************************************************/
  150.  
  151. /* Perform standard handling for check boxes and radio buttons. For radio
  152.    buttons, we assume that the group for the radio button extends forward
  153.    and backward in the DITL as long as the item type is radio button. */
  154.    
  155. void PerformStandardDialogItemHandling (DialogPtr dp, short item);
  156.  
  157. /*****************************************************************************/
  158.  
  159. #ifdef __cplusplus
  160. } /* End of extern "C" block. */
  161. #endif
  162.  
  163. /*****************************************************************************/
  164.  
  165. #endif /* __DialogUtilities__ */
  166.